.. _cmmCmpQue_GetLtcLinkMode:

cmmCmpQue_GetLtcLinkMode
============================
----------------------------

SYNOPSIS
```````````

.. code-block:: none

    VT_I4 cmmCmpQue_GetLtcLinkMode(
      [in] VT_I4 Axis, [out] VT_PI4 Enable, 
      [out] VT_PI4 SrcLtcCnt, [out] VT_PI4 CmpSrc,
      [out] VT_PI4 CmpMethod, [out] VT_PI4 Offset
      )

     
DESCRIPTION
```````````````

- cmmCmpQue_GetLtcLinkMode() 함수는 이에 대한 설정이 정상적으로 등록되었는지 각 항에 대하여 확인하는
  함수입니다.


PARAMETER
```````````

- Axis: 축번호. 축번호는 상수값으로 [cmX1] 부터 0 번째 축을 기준 축으로 임의의 축을 설정할 수 있습니다.

\

- Enable: LTC 입력으로부터 위치비교출력을 활성화할 것인지 설정합니다.

.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0 또는 cmFALSE, LTC LINK 사용 안함
  1 또는 cmTRUE, LTC LINK 사용

- SrcLtcCnt : LTC 입력 대상 카운터를 설정합니다.

.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0 또는 cmCNT_COMM, Command Counter 
  1 또는 cmCNT_FEED, Feedback Counter
  2 또는 cmCNT_DEV, Deviation Counter : Command 와 Feedback counter 의 편차 카운터
  3 또는 cmCNT_GEN, General Counter : 사용자의 정의에 따라 여러가지 용도로 사용될 수 있는 카운터

- CmpSrc : 비교 대상 카운터를 설정합니다.

.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0 또는 cmCNT_COMM, Command Counter 
  1 또는 cmCNT_FEED, Feedback Counter
  2 또는 cmCNT_DEV, Deviation Counter : Command 와 Feedback counter 의 편차 카운터
  3 또는 cmCNT_GEN, General Counter : 사용자의 정의에 따라 여러가지 용도로 사용될 수 있는 카운터

- CmpMethod : cmmCmpQue_Enque 함수의 인자이며, CMP 신호 출력 조건을 설정합니다. 즉, 비교 대상 카운트값과
  사용자가 지정한 데이터 값을 어떻게 비교하여 CMP 신호 출력을 발생할지에 대한 조건을 결정합니다.

.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0 (cmDISABLE), Disable comparator
  1 (cmEQ_BIDIR), CmpData = CmpSrc_Value (regardless of counting direction)
  2 (cmEQ_PDIR), CmpData = CmpSrc_Value (while counting up)
  3 (cmEQ_NDIR), CmpData = CmpSrc_Value (while counting down)  
  4 (cmLESS), CmpData > CmpSrc_Value 
  5 (cmGREATER), CmpData < CmpSrc_Value

- Offset: LTC 신호 입력 후 지연 출력 될 위치 비교 신호의 오프셋을 지정합니다. LTC 신호가 입력된 시점으로부터
  이 인자에 지정된 Offset 만큼의 펄스 출력 이후에 CMP 신호를 출력합니다.


RETURN VALUE
`````````````
.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  음수, 수행 실패
  cmERR_NONE, 수행 성공


EXAMPLE
`````````

-  아래의 예제에서는 X 축에 대하여 Command Counter 값을 LTC 로 입력받아 입력 받은 지점에서 50000 pulse 위치
  이후에서 위치비교(CMP)를 출력하도록 설정하였습니다. 
  만약 LTC 입력위치가 10,000 인 경우, 해당 축에서 실제 출력되는 CMP 신호는 60,000 의 위치에서 발생하게 됩니다.

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

 C/C++

 long nOffset;

 nOffset = 50000;
 
 cmmCmpQue_SetLtcLinkMode(cmX1, TRUE, cmCNT_COMM, cmCNT_COMM, cmEQ_BIDIR, nOffset);